, ,

La météo avec conkyForecast

conkyForecast est un script écrit en Python qui permet d'afficher la météo sur le bureau grâce à Conky. Les informations sont récupérées sur le site Weather.com à l'aide du service XOAP.

L'ensemble est extrêmement configurable et les prévisions peuvent être paramétrées jusqu'à 5 jours.

1) Pré-requis

2) Installation

Ce logiciel n'est pas issu des dépôts officiels, vous l'installez à vos risques et périls !

Ajoutez le dépôt ci-dessous correspondant votre distribution pour installer l'application "Conkyforecast":

Pour Lucid Lynx 10.04 :

deb http://ppa.launchpad.net/conkyhardcore/ppa/ubuntu lucid main 
deb-src http://ppa.launchpad.net/conkyhardcore/ppa/ubuntu lucid main

Pour Hardy Heron :

deb http://ppa.launchpad.net/m-buck/ubuntu hardy main

Pour Ubuntu Intrepid Ibex :

deb http://ppa.launchpad.net/m-buck/ubuntu intrepid main

Puis rechargez la liste des paquets et installez le paquet conkyforecast.

Rappel Ajouter une source :

a) Menu Ubuntu : Système > Administration > Sources de Logiciels.

b) Sélectionner l'onglet " Autres logiciels".

c) Cliquez sur ajouter en bas à gauche.

d) Entrez le nom du dépôt (commençant par deb http: ou ppa:).

e) Cliquez sur l'icône "Ajouter une source de mises à jour".

f) En fermant la fenêtre on vous propose d'actualiser les dépôts, actualiser les dépôts.

g) Ouvrez un terminal, Menu Ubuntu : Application > Accessoires > Terminal. Copier coller le code ci-dessous :

sudo apt-get install conkyforecast

3) Inscription au service XOAP (Weather.com)

a) Pour que conkyForecast puisse récupérer les informations de la météo, il est nécessaire de s'inscrire ici (gratuit) :

b) Une fois sur le site cliquer sur le lien 'Register' en haut à droit.

c) Une fois le formulaire complété, vous recevrez un mail de confirmation dans lequel vous trouverez vos codes:

Gardez ces informations sous la main.

d) Dans le mail de confirmation je vous conseil de télécharger le dossier 'sdk'. Ce dernier contient l'ensemble des icônes météo en couleur utiliser par le site : http://download.weather.com/web/xml/sdk.zip

e) Pour trouver le code de votre ville, rendez-vous sur le site http://www.weather.com/.

f) Lancer la recherche et notez le code qui se trouve dans la barre d'adresse sous la formme 'FRXX000'.

Exemple : Code Paris : FRXX0076

4) Configuration

ConkyForecast.config

Les paramètres principaux comme la langue, le format de l'heure et de la date, ainsi que vos identifiants se trouvent dans le fichier ~/.conkyForecast.config, éditez-le. Collez le code suivant en remplaçant les XXX par les informations qui vous ont été envoyées par mail :

# config settings for conkyForecast.py
CACHE_FOLDERPATH = /tmp/
CONNECTION_TIMEOUT = 5
EXPIRY_MINUTES = 30
TIME_FORMAT = %H:%M
DATE_FORMAT = %d-%m-%Y
LOCALE = fr
XOAP_PARTNER_ID = XXXXXXXXXXX 
XOAP_LICENCE_KEY = XXXXXXXXXX

Sauvegardez puis quittez.

Exemple

Afin de vous donner une idée de ce à quoi peut ressembler la météo sur votre bureau.
Vous trouverez deux fichiers dans /usr/share/conkyforecast/example :

Vous pouvez lancer Conky à l'aide de la commande suivante :

conky -c /usr/share/conkyforecast/example/conkyrc &

Qu'en dîtes-vous ? Passons aux choses sérieuses !

Ville

Pour trouver le code de votre ville rendez-vous sur le site http://www.weather.com/
Lancez une recherche et notez le code qui se trouve dans la barre d'adresse sous la forme FRXX0000.
Il faudra l'utiliser avec l'option –location comme suit :

--location FRXX0000

Conkyrc

Avant tout il faut savoir que le script s'utilise à l'aide de la commande :

{execi 1800 conkyForecast ...options...}

Pour visionner/s'inspirer d'un conkyrc, ouvrez le fichier /usr/share/conkyforecast/example/conkyrc.

Pour consulter la liste des options disponibles :

conkyForecast -h

Vous êtes perdus ? Pas de panique !

Options

Voici la description des principales options :

Exemple :

${execi 1800 conkyForecast --location=FRXX0076 --datatype=WS}

Cela affichera la vitesse du vent (WS) pour la ville de Paris (FRXX0076)

Il est possible de combiner autant d'options que nécessaires.

A propos des polices

Les différentes polices disponibles se trouvent à cet endroit : /usr/share/fonts/truetype/conkyforecast

ConkyForecast.template

Pour structurer plus facilement son texte, il est possible d'utiliser le fichier conkyForecast.template

Voici comment structurer ce fichier :

[--datatype=DW --startday=1 --shortweekday]

[--datatype=HT --startday=1 --hideunits]/[--datatype=LT --startday=1 --hideunits]

Les options se mettent entre crochets [–options …]. Ce qui est hors des crochets sera affiché comme du texte.

Pour voir un exemple de conkyForecast.template ouvrez le fichier /usr/share/conkyforecast/example/conkyForecast.template

Enfin il faut spécifier le chemin du conkyForecast.template dans le conkyrc à l'aide de :

${execpi 1800 conkyForecast --location=MONCODE --template=/lechemindemonfichier/conkyForecast.template}
On ne peut pas utiliser les raccourcis pour les options dans le template, il faut écrire l'option en entier (ex : –datatype)
Il est désormais possible d'utiliser des caractères accentués dans le template !
L'utilisation de la commande execpi au lieu de execi permet l'utilisation des variables de conky dans le template (elles ne seraient pas interprétées dans le cas contraire).

A propos des mises à jours de la météo

Par défaut le script va vérifier les informations sur le site weather.com toutes les 30 min (1800 sec) :

${execi 1800 conkyForecast ...

Cette valeur peut être modifiée. Toutefois il faut savoir que les informations du site weather.com sont actualisées toutes les heures. Donc une mise à jour trop fréquente est inutile !

Enfin pour modifier la durée de validité des informations mises en cache, il faut modifier la ligne :

EXPIRY_MINUTES = 30

Dans le fichier ~/.conkyForecast.config

Changer "kph" en "km/h"

Par défaut l'unité de mesure pour la vitesse du vent sera en kph (km par heure). Si cela vous embête, une petite manipulation très simple vous permettra d'obtenir des km/h.
Pour cela éditez le fichier en tant que root /usr/share/conkyforecast/conkyForecast.py
Rendez-vous à la ligne 966 :

speedunit = u"kph"

Changez kph par km/h, sauvegardez puis quittez.

Problèmes rencontrés

La météo est tronquée

Si le nombre d'informations à afficher est important (symboles…), il est possible que votre Conky ne s'affiche pas correctement et qu'il manque un bout. Pour y remedier, rajoutez à votre conkyrc avant la section TEXT :

text_buffer_size 2048

Précipitations non disponibles (N/A)

Il faut rajouter l'option –startday=0 comme ceci :

--datatype=PC --startday=0

Certains caractères ne s'affichent pas correctement

Rajoutez l'option suivante à votre conkyrc avant la section TEXT :

override_utf8_locale yes

Pas de météo au démarrage

conkyForecast utilise le répertoire temporaire /tmp. Hors par défaut ce répertoire est vidé à l'extinction du système. Il vous faut donc définir un autre répertoire temporaire qui ne sera pas vidé, comme /home par exemple :

mkdir ~/.conky_tmp

Il faut changer le chemin du répertoire temporaire dans le conkyForecast.config. Pour ce faire, éditez le fichier ~/.conkyForecast.config et remplacez ce qui suit par le nouveau chemin du répertoire temporaire (le $USER mentionné ci-après doit être votre nom d'utilisateur) :

CACHE_FOLDERPATH = /home/$USER/.conky_tmp

Liens

Merci à Mark Buck @Kaivalagi pour son script ;-)